home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #11 / Amiga Plus CD - 2004 - No. 11.iso / AmiSoft / Util / crypt / sign7800.lha / sign7800.readme < prev    next >
Text File  |  2004-06-23  |  2KB  |  40 lines
  1. Short:    Generator of a valid digital signature for an Atari 7800 cartridge
  2. Author:   Bruce Tomlin. Amiga port by Wojciech Pasiecznik/Voy/SSG^Dial^SWAT
  3. Uploader: Wojciech Pasiecznik/Voy/SSG^Dial^SWAT (voydial@wp.pl)
  4. Version:  1.0
  5. Requires: MC68000+, ixemul.library
  6. Type:     util/crypt
  7.  
  8. This program will generate a valid digital signature for an Atari 7800
  9. cartridge ROM image.
  10.  
  11. The code was created by hand-decompiling the original 7800 encryption
  12. program for the Atari ST into plain C code, so it does not rely on any
  13. external libraries and should compile for almost any operating system
  14. with no muss and no fuss.
  15.  
  16.  
  17. To run it:
  18. ==========
  19.  
  20.    sign7800 -t filename   to test for a valid existing signature only
  21.    sign7800 filename      to generate a signature printed to stdout
  22.    sign7800 -w filename   to generate a signature and update the image
  23.  
  24. 'Filename' is the name of the file with the cartridge data in it.  It
  25. must be a binary file, with a size that is a multiple of 4K bytes.  An
  26. extra 128 bytes is allowed, so that you can use it with a .A78 file.
  27.  
  28. The '-t' option only tests to see if an existing signature is valid.
  29.  
  30. The '-w' option causes the file to be updated with a new signature if
  31. it was not aready valid.  A write will not happen if there is a problem
  32. with $FFF8, $FFF9, or the reset vector, or if there is already a valid
  33. signature in the file.  Even with an already valid signature, a new
  34. signature is still computed and printed to stdout.
  35.  
  36. WARNING:  using the '-w' option should be safe if your file is really a 7800
  37. cartridge image, but if it isn't, there is a possibility that data loss
  38. to the last 128 bytes of the file could occur!  Be sure that you have a
  39. backup copy of or can re-create whatever file you use with the '-w' option!
  40.